User Settings

Overview

The User Settings APIs provide access to user session data within Motadata ObserveOps. These endpoints allow administrators to retrieve information about currently active users, including browser details, operating system, session duration, and remote IP address.

Available Endpoints

Method	Endpoint	Description
GET	/settings/users/active-users	Returns a list of all users currently active in the system.

Response Fields

The GET /settings/users/active-users endpoint returns the following fields for each active session:

Field	Type	Description
user.name	string	The username of the logged-in user (e.g., admin).
user.id	integer	The unique identifier of the user.
user.type	string	The type of user account (e.g., System).
browser	string	The browser used for the session (e.g., Chrome).
version	string	The browser version (e.g., 134.0.0.0).
os	string	The operating system of the user's machine (e.g., Linux).
remote.address	string	The IP address from which the user is connected.
last.active.timestamp	integer	Unix timestamp of the user's last activity.
duration	integer	Duration of the session in seconds.
userAgent	string	The full user-agent string from the browser.

Authentication

All endpoints in this category require a valid session cookie or API token. Unauthorized requests receive a 403 Forbidden response.

Use Cases

• Session Auditing — Track who is currently logged in and from which IP address.
• Security Monitoring — Detect unexpected or unauthorized active sessions.
• Activity Tracking — Monitor session duration and last activity timestamps for users.